<!DOCTYPE html>
<html lang="en-US">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<title>reduce_object_model_3d_by_view [HALCON算子参考手册]</title>
<style type="text/css">
      body {
    color: #000000;
    background-color: #ffffff;
    margin: 0;
    font-family: Arial, Helvetica, sans-serif;
}

.body_main {
    margin-left: 35px;
    margin-right: 35px;
}

@media screen and (min-width:992px) {

    .body_main {
        margin-left: 10%;
        margin-right: 10%;
    }

    table.toctable {
        width: 80%
    }
}

@media screen and (min-width:1400px) {

    .body_main {
        margin-left: 15%;
        margin-right: 15%;
    }

    table.toctable {
        width: 70%
    }
}

body>div ul ul {
    margin-left: inherit;
}

a:link {
    color: #0044cc;
}

a:link,
a:visited {
    text-decoration: none;
}

a:link:hover,
a:visited:hover {
    text-decoration: underline;
}

th {
    text-align: left;
}

h1,
h2,
h3,
h4,
h5,
h6 {
    text-rendering: optimizeLegibility;
    color: #666666;
}

code {
    font-family: monospace,monospace;
}

h1 a.halconoperator {
    font-family: Arial, Helvetica, sans-serif;
    color: #666666;
}

h2 a.halconoperator {
    font-family: Arial, Helvetica, sans-serif;
    color: #666666;
}

hr {
    border: 0;
    border-top: solid 1px #f28d26;
}

.pre {
    display: block;
    padding-bottom: 1ex;
    font-family: monospace;
    white-space: pre;
}

pre {
    font-family: monospace, monospace;
    padding: 1ex;
    white-space: pre-wrap;
}

.toc {
    font-size: 80%;
    border-top: 1px dashed #f28d26;
    border-bottom: 1px dashed #f28d26;
    padding-top: 5px;
    padding-bottom: 5px;
}

.inv {
    margin: 0;
    border: 0;
    padding: 0;
}

.banner {
    color: #666666;
    padding-left: 1em;
}

.logo {
    background-color: white;
}

.keyboard {
    font-size: 80%;
    padding-left: 3px;
    padding-right: 3px;
    border-radius: 5px;
    border-width: 1px;
    border-style: solid;
    border-color: #f28d26;
    background-color: #f3f3f3;
}

.warning {
    margin-top: 2ex;
    margin-bottom: 1ex;
    padding: 10px;
    text-align: center;
    border: 1px solid;
    color: #bb0000;
    background-color: #fff7f7
}

.imprint {
    margin-top: 1ex;
    font-size: 80%;
    color: #666666;
}

.imprinthead {
    font-weight: bolder;
    color: #666666;
}

.indexlink {
    text-align: right;
    padding-bottom: 5px;
}

.postscript {
    margin-top: 2ex;
    font-size: 80%;
    color: #666666
}

.evenrow {
    background-color: #e7e7ef;
    vertical-align: top;
}

.oddrow {
    background-color: #f7f7ff;
    vertical-align: top;
}

.headrow {
    background-color: #97979f;
    color: #ffffff;
    vertical-align: top;
}

.logorow {
    vertical-align: top;
}

.error {
    color: red;
}

.var {
    font-style: italic
}

.halconoperator {
    font-family: monospace, monospace;
}

span.operator {
    font-family: monospace, monospace;
}

span.procedure {
    font-family: monospace, monospace;
}

span.operation {
    font-family: monospace, monospace;
}

span.feature {
    font-family: Arial, Helvetica, Homerton, sans-serif;
}

ul {
    padding-left: 1.2em;
}

li.dot {
    list-style-type: square;
    color: #f28d26;
}

.breadcrumb {
    font-size: 80%;
    color: white;
    background-color: #062d64;
    margin-bottom: 20px;
    padding-left: 35px;
    padding-right: 35px;
    padding-bottom: 15px;
}

.webbar {
    font-size: 80%;
    background-color: #dddddd;
    margin-top: 0px;
    margin-left: -35px;
    margin-right: -35px;
    margin-bottom: 0px;
    padding-top: 5px;
    padding-left: 35px;
    padding-right: 35px;
    padding-bottom: 5px;
}

.footer {
    display: flex;
    flex-wrap: wrap;
    justify-content: space-between;
    border-top: 1px dashed #f28d26;
    font-size: 80%;
    color: #666666;
    padding-bottom: 8px;
}

.footer .socialmedia a {
    padding-left: 7px;
}

.socialmedia {
    padding-top: 10px;
}

.copyright {
    margin-top: 19px;
}

.breadcrumb a {
    color: #ffffff;
    border-bottom: 1px solid white;
}

.breadcrumb a:link:hover,
.breadcrumb a:visited:hover {
    text-decoration: none;
    border-bottom: none;
}

.heading {
    margin-top: 1ex;
    font-size: 110%;
    font-weight: bold;
    color: #666666;
}

.text {
    color: black;
}

.example {
    font-size: 80%;
    background-color: #f3f3f3;
    border: 1px dashed #666666;
    padding: 10px;
}

.displaymath {
    display: block;
    text-align: center;
    margin-top: 1ex;
    margin-bottom: 1ex;
}

.title {
    float: left;
    padding-top: 3px;
    padding-bottom: 3px;
}

.signnote {
    font-family: Arial, Helvetica, Homerton, sans-serif;
    font-size: 80%;
    color: #666666;
    font-weight: lighter;
    font-style: italic
}

.par {
    margin-bottom: 1.5em;
}

.parhead {
    text-align: right;
}

.parname {
    float: left;
}

.pardesc {
    font-size: 85%;
    margin-top: 0.5em;
    margin-bottom: 0.5em;
    margin-left: 2em;
}

.parcat {
    color: #666;
    font-weight: bold;
}

*[data-if=cpp],
*[data-if=c],
*[data-if=dotnet],
*[data-if=com],
*[data-if=python] {
    display: none;
}

.tabbar {
    text-align: right;
    border-bottom: 1px solid #f28d26;
    margin-bottom: 0.5em;
}

ul.tabs {
    padding-top: 3px;
    padding-bottom: 3px;
    margin-top: 10px;
    margin-bottom: 0;
    font-size: 80%
}

ul.tabs li {
    padding-top: 3px;
    padding-bottom: 3px;
    display: inline;
    overflow: hidden;
    list-style-type: none;
    margin: 0;
    margin-left: 8px;
    border-top: 1px solid #666;
    border-left: 1px solid #666;
    border-right: 1px solid #666;
}

ul.tabs li.active {
    border-left: 1px solid #f28d26;
    border-right: 1px solid #f28d26;
    border-top: 1px solid #f28d26;
    border-bottom: 1px solid #fff;
}

ul.tabs li.inactive {
    background-color: #eee;
}

ul.tabs li a {
    padding-left: 5px;
    padding-right: 5px;
    color: #666;
}

ul.tabs li a:link:hover {
    text-decoration: none;
}

ul.tabs li.inactive a {
    color: #666;
}

ul.tabs li.active a {
    color: black;
}

dl.generic dd {
    margin-bottom: 1em;
}

.pari {
    color: olive;
}

.paro {
    color: maroon;
}

.comment {
    font-size: 80%;
    color: green;
    white-space: nowrap;
}

table.grid {
    border-collapse: collapse;
}

table.grid td {
    padding: 5px;
    border: 1px solid;
}

table.layout {
    border: 0px;
}

table.layout td {
    padding: 5px;
}

table.table {
    border-collapse: collapse;
}

table.table td {
    padding: 5px;
    border-left: 0px;
    border-right: 0px;
}

table.table tr:last-child {
    border-bottom: 1px solid;
}

table.table th {
    padding: 5px;
    border-top: 1px solid;
    border-bottom: 1px solid;
    border-left: 0px;
    border-right: 0px;
}

.details_summary {
    cursor: pointer;
}

table.toctable {
    width: 100%;
}

table.toctable col:first-child {
    width: 20%;
}

table.toctable col:nth-last-child(2) {
    width: 8%;
}

table.altcolored tr:nth-child(even) {
    background-color: #f3f3f3;
}

    </style>
<!--OP_REF_STYLE_END-->
<script>
    <!--
var active_lang='hdevelop';function switchVisibility(obj,active_lang,new_lang)
{var display_style='inline';
for(var i=0;i<obj.length;i++)
{if(obj.item(i).getAttribute('data-if')==new_lang)
{obj.item(i).style.display=display_style;}
if(obj.item(i).getAttribute('data-if')==active_lang)
{obj.item(i).style.display='none';}}
return;}
function toggleLanguage(new_lang,initial)
{if(active_lang!=new_lang)
{var lis=document.getElementsByTagName('li');for(var i=0;i<lis.length;i++)
{if(lis.item(i).id=='syn-'+new_lang)
{lis.item(i).className='active';}
else
{lis.item(i).className='inactive';}}
var divs=document.getElementsByTagName('div');var spans=document.getElementsByTagName('span');switchVisibility(divs,active_lang,new_lang);switchVisibility(spans,active_lang,new_lang);if(!initial)
{setCookie("halcon_reference_language",new_lang,null,null);}
active_lang=new_lang;}
return;}
function setCookie(name,value,domain,exp_offset,path,secure)
{localStorage.setItem(name,value);}
function getCookie(name)
{return localStorage.getItem(name);}
function initialize()
{var qs=location.href.split('?')[1];var qs_lang_raw=location.href.split('interface=')[1];var qs_lang;if(qs_lang_raw)
{qs_lang=qs_lang_raw.split('#')[0];}
var cookie_lang=getCookie("halcon_reference_language");var new_lang;if((qs_lang=="hdevelop")||(qs_lang=="dotnet")||(qs_lang=="python")||(qs_lang=="cpp")||(qs_lang=="c"))
{new_lang=qs_lang;setCookie("halcon_reference_language",new_lang,null,null);}
else if((cookie_lang=="hdevelop")||(cookie_lang=="dotnet")||(cookie_lang=="python")||(cookie_lang=="cpp")||(cookie_lang=="c"))
{new_lang=cookie_lang;}
else
{new_lang="hdevelop";}
toggleLanguage(new_lang,1);return;}
-->

  </script>
</head>
<body onload="initialize();">
<div class="breadcrumb">
<br class="inv"><a href="index.html">目录</a> / <a href="toc_3dobjectmodel.html">3D Object Model</a> / <a href="toc_3dobjectmodel_segmentation.html">分割</a><br class="inv">
</div>
<div class="body_main">
<div class="tabbar"><ul class="tabs">
<li id="syn-hdevelop" class="active"><a href="javascript:void(0);" onclick="toggleLanguage('hdevelop')" onfocus="blur()">HDevelop</a></li>
<li id="syn-dotnet" class="inactive"><a href="javascript:void(0);" onclick="toggleLanguage('dotnet')" onfocus="blur()">.NET</a></li>
<li id="syn-python" class="inactive"><a href="javascript:void(0);" onclick="toggleLanguage('python')" onfocus="blur()">Python</a></li>
<li id="syn-cpp" class="inactive"><a href="javascript:void(0);" onclick="toggleLanguage('cpp')" onfocus="blur()">C++</a></li>
<li id="syn-c" class="inactive"><a href="javascript:void(0);" onclick="toggleLanguage('c')" onfocus="blur()">C</a></li>
</ul></div>
<div class="indexlink">
<a href="index_classes.html"><span data-if="dotnet" style="display:none;">类别</span><span data-if="cpp" style="display:none;">类别</span></a><span data-if="dotnet" style="display:none;"> | </span><span data-if="cpp" style="display:none;"> | </span><a href="index_by_name.html">算子列表</a>
</div>
<!--OP_REF_HEADER_END-->
<h1 id="sec_name">
<span data-if="hdevelop" style="display:inline;">reduce_object_model_3d_by_view</span><span data-if="c" style="display:none;">T_reduce_object_model_3d_by_view</span><span data-if="cpp" style="display:none;">ReduceObjectModel3dByView</span><span data-if="dotnet" style="display:none;">ReduceObjectModel3dByView</span><span data-if="python" style="display:none;">reduce_object_model_3d_by_view</span> (算子名称)</h1>
<h2>名称</h2>
<p><code><span data-if="hdevelop" style="display:inline;">reduce_object_model_3d_by_view</span><span data-if="c" style="display:none;">T_reduce_object_model_3d_by_view</span><span data-if="cpp" style="display:none;">ReduceObjectModel3dByView</span><span data-if="dotnet" style="display:none;">ReduceObjectModel3dByView</span><span data-if="python" style="display:none;">reduce_object_model_3d_by_view</span></code> — Remove points from a 3D object model by projecting it to a virtual view
and removing all points outside of a given region.</p>
<h2 id="sec_synopsis">参数签名</h2>
<div data-if="hdevelop" style="display:inline;">
<p>
<code><b>reduce_object_model_3d_by_view</b>(<a href="#Region"><i>区域</i></a> :  : <a href="#ObjectModel3D"><i>ObjectModel3D</i></a>, <a href="#CamParam"><i>CamParam</i></a>, <a href="#Pose"><i>Pose</i></a> : <a href="#ObjectModel3DReduced"><i>ObjectModel3DReduced</i></a>)</code></p>
</div>
<div data-if="c" style="display:none;">
<p>
<code>Herror <b>T_reduce_object_model_3d_by_view</b>(const Hobject <a href="#Region"><i>区域</i></a>, const Htuple <a href="#ObjectModel3D"><i>ObjectModel3D</i></a>, const Htuple <a href="#CamParam"><i>CamParam</i></a>, const Htuple <a href="#Pose"><i>Pose</i></a>, Htuple* <a href="#ObjectModel3DReduced"><i>ObjectModel3DReduced</i></a>)</code></p>
</div>
<div data-if="cpp" style="display:none;">
<p>
<code>void <b>ReduceObjectModel3dByView</b>(const HObject&amp; <a href="#Region"><i>区域</i></a>, const HTuple&amp; <a href="#ObjectModel3D"><i>ObjectModel3D</i></a>, const HTuple&amp; <a href="#CamParam"><i>CamParam</i></a>, const HTuple&amp; <a href="#Pose"><i>Pose</i></a>, HTuple* <a href="#ObjectModel3DReduced"><i>ObjectModel3DReduced</i></a>)</code></p>
<p>
<code>static HObjectModel3DArray <a href="HObjectModel3D.html">HObjectModel3D</a>::<b>ReduceObjectModel3dByView</b>(const HRegion&amp; <a href="#Region"><i>区域</i></a>, const HObjectModel3DArray&amp; <a href="#ObjectModel3D"><i>ObjectModel3D</i></a>, const HCamPar&amp; <a href="#CamParam"><i>CamParam</i></a>, const HPoseArray&amp; <a href="#Pose"><i>Pose</i></a>)</code></p>
<p>
<code><a href="HObjectModel3D.html">HObjectModel3D</a> <a href="HObjectModel3D.html">HObjectModel3D</a>::<b>ReduceObjectModel3dByView</b>(const HRegion&amp; <a href="#Region"><i>区域</i></a>, const HCamPar&amp; <a href="#CamParam"><i>CamParam</i></a>, const HPose&amp; <a href="#Pose"><i>Pose</i></a>) const</code></p>
<p>
<code>HObjectModel3DArray <a href="HCamPar.html">HCamPar</a>::<b>ReduceObjectModel3dByView</b>(const HRegion&amp; <a href="#Region"><i>区域</i></a>, const HObjectModel3DArray&amp; <a href="#ObjectModel3D"><i>ObjectModel3D</i></a>, const HPoseArray&amp; <a href="#Pose"><i>Pose</i></a>) const</code></p>
<p>
<code><a href="HObjectModel3D.html">HObjectModel3D</a> <a href="HCamPar.html">HCamPar</a>::<b>ReduceObjectModel3dByView</b>(const HRegion&amp; <a href="#Region"><i>区域</i></a>, const HObjectModel3D&amp; <a href="#ObjectModel3D"><i>ObjectModel3D</i></a>, const HPose&amp; <a href="#Pose"><i>Pose</i></a>) const</code></p>
<p>
<code>static HObjectModel3DArray <a href="HPose.html">HPose</a>::<b>ReduceObjectModel3dByView</b>(const HRegion&amp; <a href="#Region"><i>区域</i></a>, const HObjectModel3DArray&amp; <a href="#ObjectModel3D"><i>ObjectModel3D</i></a>, const HCamPar&amp; <a href="#CamParam"><i>CamParam</i></a>, const HPoseArray&amp; <a href="#Pose"><i>Pose</i></a>)</code></p>
<p>
<code><a href="HObjectModel3D.html">HObjectModel3D</a> <a href="HPose.html">HPose</a>::<b>ReduceObjectModel3dByView</b>(const HRegion&amp; <a href="#Region"><i>区域</i></a>, const HObjectModel3D&amp; <a href="#ObjectModel3D"><i>ObjectModel3D</i></a>, const HCamPar&amp; <a href="#CamParam"><i>CamParam</i></a>) const</code></p>
</div>
<div data-if="com" style="display:none;"></div>
<div data-if="dotnet" style="display:none;">
<p>
<code>static void <a href="HOperatorSet.html">HOperatorSet</a>.<b>ReduceObjectModel3dByView</b>(<a href="HObject.html">HObject</a> <a href="#Region"><i>区域</i></a>, <a href="HTuple.html">HTuple</a> <a href="#ObjectModel3D"><i>objectModel3D</i></a>, <a href="HTuple.html">HTuple</a> <a href="#CamParam"><i>camParam</i></a>, <a href="HTuple.html">HTuple</a> <a href="#Pose"><i>pose</i></a>, out <a href="HTuple.html">HTuple</a> <a href="#ObjectModel3DReduced"><i>objectModel3DReduced</i></a>)</code></p>
<p>
<code>static <a href="HObjectModel3D.html">HObjectModel3D[]</a> <a href="HObjectModel3D.html">HObjectModel3D</a>.<b>ReduceObjectModel3dByView</b>(<a href="HRegion.html">HRegion</a> <a href="#Region"><i>区域</i></a>, <a href="HObjectModel3D.html">HObjectModel3D[]</a> <a href="#ObjectModel3D"><i>objectModel3D</i></a>, <a href="HCamPar.html">HCamPar</a> <a href="#CamParam"><i>camParam</i></a>, <a href="HPose.html">HPose[]</a> <a href="#Pose"><i>pose</i></a>)</code></p>
<p>
<code><a href="HObjectModel3D.html">HObjectModel3D</a> <a href="HObjectModel3D.html">HObjectModel3D</a>.<b>ReduceObjectModel3dByView</b>(<a href="HRegion.html">HRegion</a> <a href="#Region"><i>区域</i></a>, <a href="HCamPar.html">HCamPar</a> <a href="#CamParam"><i>camParam</i></a>, <a href="HPose.html">HPose</a> <a href="#Pose"><i>pose</i></a>)</code></p>
<p>
<code><a href="HObjectModel3D.html">HObjectModel3D[]</a> <a href="HCamPar.html">HCamPar</a>.<b>ReduceObjectModel3dByView</b>(<a href="HRegion.html">HRegion</a> <a href="#Region"><i>区域</i></a>, <a href="HObjectModel3D.html">HObjectModel3D[]</a> <a href="#ObjectModel3D"><i>objectModel3D</i></a>, <a href="HPose.html">HPose[]</a> <a href="#Pose"><i>pose</i></a>)</code></p>
<p>
<code><a href="HObjectModel3D.html">HObjectModel3D</a> <a href="HCamPar.html">HCamPar</a>.<b>ReduceObjectModel3dByView</b>(<a href="HRegion.html">HRegion</a> <a href="#Region"><i>区域</i></a>, <a href="HObjectModel3D.html">HObjectModel3D</a> <a href="#ObjectModel3D"><i>objectModel3D</i></a>, <a href="HPose.html">HPose</a> <a href="#Pose"><i>pose</i></a>)</code></p>
<p>
<code>static <a href="HObjectModel3D.html">HObjectModel3D[]</a> <a href="HPose.html">HPose</a>.<b>ReduceObjectModel3dByView</b>(<a href="HRegion.html">HRegion</a> <a href="#Region"><i>区域</i></a>, <a href="HObjectModel3D.html">HObjectModel3D[]</a> <a href="#ObjectModel3D"><i>objectModel3D</i></a>, <a href="HCamPar.html">HCamPar</a> <a href="#CamParam"><i>camParam</i></a>, <a href="HPose.html">HPose[]</a> <a href="#Pose"><i>pose</i></a>)</code></p>
<p>
<code><a href="HObjectModel3D.html">HObjectModel3D</a> <a href="HPose.html">HPose</a>.<b>ReduceObjectModel3dByView</b>(<a href="HRegion.html">HRegion</a> <a href="#Region"><i>区域</i></a>, <a href="HObjectModel3D.html">HObjectModel3D</a> <a href="#ObjectModel3D"><i>objectModel3D</i></a>, <a href="HCamPar.html">HCamPar</a> <a href="#CamParam"><i>camParam</i></a>)</code></p>
</div>
<div data-if="python" style="display:none;">
<p>
<code>def <b>reduce_object_model_3d_by_view</b>(<a href="#Region"><i>区域</i></a>: HObject, <a href="#ObjectModel3D"><i>object_model_3d</i></a>: MaybeSequence[HHandle], <a href="#CamParam"><i>cam_param</i></a>: Sequence[Union[int, float, str]], <a href="#Pose"><i>pose</i></a>: Sequence[Union[int, float]]) -&gt; Sequence[HHandle]</code></p>
<p>
<code>def <b>reduce_object_model_3d_by_view_s</b>(<a href="#Region"><i>区域</i></a>: HObject, <a href="#ObjectModel3D"><i>object_model_3d</i></a>: MaybeSequence[HHandle], <a href="#CamParam"><i>cam_param</i></a>: Sequence[Union[int, float, str]], <a href="#Pose"><i>pose</i></a>: Sequence[Union[int, float]]) -&gt; HHandle</code></p>
</div>
<h2 id="sec_description">描述</h2>
<p><code><span data-if="hdevelop" style="display:inline">reduce_object_model_3d_by_view</span><span data-if="c" style="display:none">reduce_object_model_3d_by_view</span><span data-if="cpp" style="display:none">ReduceObjectModel3dByView</span><span data-if="com" style="display:none">ReduceObjectModel3dByView</span><span data-if="dotnet" style="display:none">ReduceObjectModel3dByView</span><span data-if="python" style="display:none">reduce_object_model_3d_by_view</span></code> projects the points of
<a href="#ObjectModel3D"><i><code><span data-if="hdevelop" style="display:inline">ObjectModel3D</span><span data-if="c" style="display:none">ObjectModel3D</span><span data-if="cpp" style="display:none">ObjectModel3D</span><span data-if="com" style="display:none">ObjectModel3D</span><span data-if="dotnet" style="display:none">objectModel3D</span><span data-if="python" style="display:none">object_model_3d</span></code></i></a> into the image plane given by <a href="#Pose"><i><code><span data-if="hdevelop" style="display:inline">Pose</span><span data-if="c" style="display:none">Pose</span><span data-if="cpp" style="display:none">Pose</span><span data-if="com" style="display:none">Pose</span><span data-if="dotnet" style="display:none">pose</span><span data-if="python" style="display:none">pose</span></code></i></a> and
<a href="#CamParam"><i><code><span data-if="hdevelop" style="display:inline">CamParam</span><span data-if="c" style="display:none">CamParam</span><span data-if="cpp" style="display:none">CamParam</span><span data-if="com" style="display:none">CamParam</span><span data-if="dotnet" style="display:none">camParam</span><span data-if="python" style="display:none">cam_param</span></code></i></a> and reduces the 3D object model to the points lying inside
the region given in <a href="#Region"><i><code><span data-if="hdevelop" style="display:inline">区域</span><span data-if="c" style="display:none">区域</span><span data-if="cpp" style="display:none">区域</span><span data-if="com" style="display:none">区域</span><span data-if="dotnet" style="display:none">区域</span><span data-if="python" style="display:none">区域</span></code></i></a>.
In particular, the points are first transformed with the pose and then
projected using the camera parameters.
Only those points that are located inside the specified region
are copied to the new 3D object model.
</p>
<p>Faces of a mesh are only contained in the output 3D object model if all
corner points are within the region.
</p>
<p>As alternative to camera parameters and a pose, an XYZ-mapping contained
in <a href="#ObjectModel3D"><i><code><span data-if="hdevelop" style="display:inline">ObjectModel3D</span><span data-if="c" style="display:none">ObjectModel3D</span><span data-if="cpp" style="display:none">ObjectModel3D</span><span data-if="com" style="display:none">ObjectModel3D</span><span data-if="dotnet" style="display:none">objectModel3D</span><span data-if="python" style="display:none">object_model_3d</span></code></i></a> can be used for the reduction.
For this, <a href="#CamParam"><i><code><span data-if="hdevelop" style="display:inline">CamParam</span><span data-if="c" style="display:none">CamParam</span><span data-if="cpp" style="display:none">CamParam</span><span data-if="com" style="display:none">CamParam</span><span data-if="dotnet" style="display:none">camParam</span><span data-if="python" style="display:none">cam_param</span></code></i></a> must be set to <i><span data-if="hdevelop" style="display:inline">'xyz_mapping'</span><span data-if="c" style="display:none">"xyz_mapping"</span><span data-if="cpp" style="display:none">"xyz_mapping"</span><span data-if="com" style="display:none">"xyz_mapping"</span><span data-if="dotnet" style="display:none">"xyz_mapping"</span><span data-if="python" style="display:none">"xyz_mapping"</span></i>
or an empty tuple and
an empty tuple must be passed to <a href="#Pose"><i><code><span data-if="hdevelop" style="display:inline">Pose</span><span data-if="c" style="display:none">Pose</span><span data-if="cpp" style="display:none">Pose</span><span data-if="com" style="display:none">Pose</span><span data-if="dotnet" style="display:none">pose</span><span data-if="python" style="display:none">pose</span></code></i></a>.
In this case, the original image coordinates of the 3D points
are used to check if a point is inside <a href="#Region"><i><code><span data-if="hdevelop" style="display:inline">区域</span><span data-if="c" style="display:none">区域</span><span data-if="cpp" style="display:none">区域</span><span data-if="com" style="display:none">区域</span><span data-if="dotnet" style="display:none">区域</span><span data-if="python" style="display:none">区域</span></code></i></a>.
</p>
<h2 id="sec_attention">注意</h2>
<p>Cameras with hypercentric lenses are not supported.</p>
<h2 id="sec_execution">运行信息</h2>
<ul>
  <li>多线程类型:可重入(与非独占操作符并行运行)。</li>
<li>多线程作用域:全局(可以从任何线程调用)。</li>
  <li>未经并行化处理。</li>
</ul>
<h2 id="sec_parameters">参数表</h2>
  <div class="par">
<div class="parhead">
<span id="Region" class="parname"><b><code><span data-if="hdevelop" style="display:inline">区域</span><span data-if="c" style="display:none">区域</span><span data-if="cpp" style="display:none">区域</span><span data-if="com" style="display:none">区域</span><span data-if="dotnet" style="display:none">区域</span><span data-if="python" style="display:none">区域</span></code></b> (input_object)  </span><span>region(-array) <code>→</code> <span data-if="hdevelop" style="display:inline">object</span><span data-if="dotnet" style="display:none"><a href="HRegion.html">HRegion</a></span><span data-if="python" style="display:none">HObject</span><span data-if="cpp" style="display:none"><a href="HRegion.html">HRegion</a></span><span data-if="c" style="display:none">Hobject</span></span>
</div>
<p class="pardesc">Region in the image plane.</p>
</div>
  <div class="par">
<div class="parhead">
<span id="ObjectModel3D" class="parname"><b><code><span data-if="hdevelop" style="display:inline">ObjectModel3D</span><span data-if="c" style="display:none">ObjectModel3D</span><span data-if="cpp" style="display:none">ObjectModel3D</span><span data-if="com" style="display:none">ObjectModel3D</span><span data-if="dotnet" style="display:none">objectModel3D</span><span data-if="python" style="display:none">object_model_3d</span></code></b> (input_control)  </span><span>object_model_3d(-array) <code>→</code> <span data-if="dotnet" style="display:none"><a href="HObjectModel3D.html">HObjectModel3D</a>, </span><span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">MaybeSequence[HHandle]</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (handle)</span><span data-if="dotnet" style="display:none"> (<i>IntPtr</i>)</span><span data-if="cpp" style="display:none"> (<i>HHandle</i>)</span><span data-if="c" style="display:none"> (<i>handle</i>)</span></span>
</div>
<p class="pardesc">Handle of the 3D object model.</p>
</div>
  <div class="par">
<div class="parhead">
<span id="CamParam" class="parname"><b><code><span data-if="hdevelop" style="display:inline">CamParam</span><span data-if="c" style="display:none">CamParam</span><span data-if="cpp" style="display:none">CamParam</span><span data-if="com" style="display:none">CamParam</span><span data-if="dotnet" style="display:none">camParam</span><span data-if="python" style="display:none">cam_param</span></code></b> (input_control)  </span><span>campar <code>→</code> <span data-if="dotnet" style="display:none"><a href="HCamPar.html">HCamPar</a>, </span><span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">Sequence[Union[int, float, str]]</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (real / </span><span data-if="hdevelop" style="display:inline">integer / </span><span data-if="hdevelop" style="display:inline">string)</span><span data-if="dotnet" style="display:none"> (<i>double</i> / </span><span data-if="dotnet" style="display:none">int / </span><span data-if="dotnet" style="display:none">long / </span><span data-if="dotnet" style="display:none">string)</span><span data-if="cpp" style="display:none"> (<i>double</i> / </span><span data-if="cpp" style="display:none">Hlong / </span><span data-if="cpp" style="display:none">HString)</span><span data-if="c" style="display:none"> (<i>double</i> / </span><span data-if="c" style="display:none">Hlong / </span><span data-if="c" style="display:none">char*)</span></span>
</div>
<p class="pardesc">Internal camera parameters.</p>
<p class="pardesc"><span class="parcat">Suggested values:
      </span><span data-if="hdevelop" style="display:inline">'xyz_mapping'</span><span data-if="c" style="display:none">"xyz_mapping"</span><span data-if="cpp" style="display:none">"xyz_mapping"</span><span data-if="com" style="display:none">"xyz_mapping"</span><span data-if="dotnet" style="display:none">"xyz_mapping"</span><span data-if="python" style="display:none">"xyz_mapping"</span>, []</p>
</div>
  <div class="par">
<div class="parhead">
<span id="Pose" class="parname"><b><code><span data-if="hdevelop" style="display:inline">Pose</span><span data-if="c" style="display:none">Pose</span><span data-if="cpp" style="display:none">Pose</span><span data-if="com" style="display:none">Pose</span><span data-if="dotnet" style="display:none">pose</span><span data-if="python" style="display:none">pose</span></code></b> (input_control)  </span><span>pose(-array) <code>→</code> <span data-if="dotnet" style="display:none"><a href="HPose.html">HPose</a>, </span><span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">Sequence[Union[int, float]]</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (real / </span><span data-if="hdevelop" style="display:inline">integer)</span><span data-if="dotnet" style="display:none"> (<i>double</i> / </span><span data-if="dotnet" style="display:none">int / </span><span data-if="dotnet" style="display:none">long)</span><span data-if="cpp" style="display:none"> (<i>double</i> / </span><span data-if="cpp" style="display:none">Hlong)</span><span data-if="c" style="display:none"> (<i>double</i> / </span><span data-if="c" style="display:none">Hlong)</span></span>
</div>
<p class="pardesc">3D pose of the world coordinate system in camera
coordinates.</p>
<p class="pardesc"><span class="parcat">Number of elements:
      </span>Pose == 7</p>
</div>
  <div class="par">
<div class="parhead">
<span id="ObjectModel3DReduced" class="parname"><b><code><span data-if="hdevelop" style="display:inline">ObjectModel3DReduced</span><span data-if="c" style="display:none">ObjectModel3DReduced</span><span data-if="cpp" style="display:none">ObjectModel3DReduced</span><span data-if="com" style="display:none">ObjectModel3DReduced</span><span data-if="dotnet" style="display:none">objectModel3DReduced</span><span data-if="python" style="display:none">object_model_3dreduced</span></code></b> (output_control)  </span><span>object_model_3d(-array) <code>→</code> <span data-if="dotnet" style="display:none"><a href="HObjectModel3D.html">HObjectModel3D</a>, </span><span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">Sequence[HHandle]</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (handle)</span><span data-if="dotnet" style="display:none"> (<i>IntPtr</i>)</span><span data-if="cpp" style="display:none"> (<i>HHandle</i>)</span><span data-if="c" style="display:none"> (<i>handle</i>)</span></span>
</div>
<p class="pardesc">Handle of the reduced 3D object model.</p>
</div>
<h2 id="sec_example_all">例程 (HDevelop)</h2>
<pre class="example">
gen_object_model_3d_from_points (200*(rand(100)-0.5), \
                                 200*(rand(100)-0.5), \
                                 200*(rand(100)-0.5), ObjectModel3D)
gen_circle (Circle, 240, 320, 60)
CamParam := ['area_scan_telecentric_division',1,0,1,1,320,240,640,480]
Pose := [0,0,1,0,0,0,0]
reduce_object_model_3d_by_view (Circle, ObjectModel3D, CamParam, \
                                Pose, ObjectModel3DReduced)
dev_get_window (WindowHandle)
visualize_object_model_3d (WindowHandle, [ObjectModel3D, \
                           ObjectModel3DReduced], CamParam, Pose, \
                           ['color_0', 'point_size_1'], ['blue',6], \
                           [], [], [], PoseOut)
</pre>
<h2 id="sec_result">结果</h2>
<p><code><span data-if="hdevelop" style="display:inline">reduce_object_model_3d_by_view</span><span data-if="c" style="display:none">reduce_object_model_3d_by_view</span><span data-if="cpp" style="display:none">ReduceObjectModel3dByView</span><span data-if="com" style="display:none">ReduceObjectModel3dByView</span><span data-if="dotnet" style="display:none">ReduceObjectModel3dByView</span><span data-if="python" style="display:none">reduce_object_model_3d_by_view</span></code> returns <TT>2</TT> (
      <TT>H_MSG_TRUE</TT>)
     if all parameters
are correct. 如有必要，将引发异常。</p>
<h2 id="sec_predecessors">可能的前置算子</h2>
<p>
<code><a href="read_object_model_3d.html"><span data-if="hdevelop" style="display:inline">read_object_model_3d</span><span data-if="c" style="display:none">read_object_model_3d</span><span data-if="cpp" style="display:none">ReadObjectModel3d</span><span data-if="com" style="display:none">ReadObjectModel3d</span><span data-if="dotnet" style="display:none">ReadObjectModel3d</span><span data-if="python" style="display:none">read_object_model_3d</span></a></code>, 
<code><a href="xyz_to_object_model_3d.html"><span data-if="hdevelop" style="display:inline">xyz_to_object_model_3d</span><span data-if="c" style="display:none">xyz_to_object_model_3d</span><span data-if="cpp" style="display:none">XyzToObjectModel3d</span><span data-if="com" style="display:none">XyzToObjectModel3d</span><span data-if="dotnet" style="display:none">XyzToObjectModel3d</span><span data-if="python" style="display:none">xyz_to_object_model_3d</span></a></code>
</p>
<h2 id="sec_successors">可能的后置算子</h2>
<p>
<code><a href="project_object_model_3d.html"><span data-if="hdevelop" style="display:inline">project_object_model_3d</span><span data-if="c" style="display:none">project_object_model_3d</span><span data-if="cpp" style="display:none">ProjectObjectModel3d</span><span data-if="com" style="display:none">ProjectObjectModel3d</span><span data-if="dotnet" style="display:none">ProjectObjectModel3d</span><span data-if="python" style="display:none">project_object_model_3d</span></a></code>, 
<code><a href="object_model_3d_to_xyz.html"><span data-if="hdevelop" style="display:inline">object_model_3d_to_xyz</span><span data-if="c" style="display:none">object_model_3d_to_xyz</span><span data-if="cpp" style="display:none">ObjectModel3dToXyz</span><span data-if="com" style="display:none">ObjectModel3dToXyz</span><span data-if="dotnet" style="display:none">ObjectModel3dToXyz</span><span data-if="python" style="display:none">object_model_3d_to_xyz</span></a></code>
</p>
<h2 id="sec_see">参考其它</h2>
<p>
<code><a href="select_points_object_model_3d.html"><span data-if="hdevelop" style="display:inline">select_points_object_model_3d</span><span data-if="c" style="display:none">select_points_object_model_3d</span><span data-if="cpp" style="display:none">SelectPointsObjectModel3d</span><span data-if="com" style="display:none">SelectPointsObjectModel3d</span><span data-if="dotnet" style="display:none">SelectPointsObjectModel3d</span><span data-if="python" style="display:none">select_points_object_model_3d</span></a></code>
</p>
<h2 id="sec_module">模块</h2>
<p>
3D Metrology</p>
<!--OP_REF_FOOTER_START-->
<hr>
<div class="indexlink">
<a href="index_classes.html"><span data-if="dotnet" style="display:none;">类别</span><span data-if="cpp" style="display:none;">类别</span></a><span data-if="dotnet" style="display:none;"> | </span><span data-if="cpp" style="display:none;"> | </span><a href="index_by_name.html">算子列表</a>
</div>
<div class="footer">
<div class="copyright">HALCON算子参考手册 Copyright © 2015-2023 51Halcon</div>
</div>
</div>
</body>
</html>
